2.0x hexo迁移至最新版本笔记

  今天看到zhiqiu的hexo有年/月视图的特性,


心想这是自己需要的功能,这样会让All-list里面的归档更为清晰,就按照网上提示,只需修改根目录下_config.yml,添加如下配置:

1
2
3
4
archive_generator:
per_page: 50 ##歸檔頁面50篇文章標題
yearly: true ##生成年視圖
monthly: true ##生成月視圖

发现并没有什么卵用!所以就以为是hexo版本的问题,想想也是该为hexo升级一下了。但是,这是件危险的问题,建议先把博客workspace,即整个文件夹备份!! 万一,那些.md文件木有了,是一件非常苦逼的事。其实,先说句后话,上述所述的特性其实换个theme就有了,之前使用的是light,需要更换为landscape 。而且,也不需要修改什么配置,就有这个功能,至于年/月视图,其实是右边栏中的这个:


  要想实现这个效果,除了按照上述配置根目录下的_config.yml文件外,还需要在/theme/对应主题/目录下的_config.yml文件中启用相应的widgets(归档)。

1
2
3
4
5
6
7
8
widgets: 			# 站点右边栏
#- search # 搜索
- category # 分类
- tag # 标签
#- archive # 归档
- blogroll # 友情链接
- weibo # 微博秀
- recent_posts # 最新文章

  说了这么多题外话,还是回到我们本文的重点,Migrating from 2.x to newest,我是参考官方迁移文档来进行的,这里列出:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# Step1: Modify package.json
Add hexo data to package.json.
{
"hexo": {
"version": ""
}
}

# Step2: Clean cache
> hexo clean

# Step3: Install hexo-cli
> npm install hexo-cli -g

# Step4: Install Hexo
> npm install hexo --save

# Step5: Install generators
> npm install hexo-generator-index --save
> npm install hexo-generator-archive --save
> npm install hexo-generator-category --save
> npm install hexo-generator-tag --save

# Step6: Install server
> install hexo-server --save

# Step7: Install deployers
> npm install hexo-deployer-git --save
> npm install hexo-deployer-heroku --save
> npm install hexo-deployer-rsync --save
> npm install hexo-deployer-openshift --save

# Step8(个人认为这一步可选): Update plugins
> npm install hexo-renderer-marked@0.2 --save
> npm install hexo-renderer-stylus@0.2 --save
> npm install hexo-generator-feed@1 --save
> npm install hexo-generator-sitemap@1 --save

  更新之后也许你会像我一样遇到这样的问题,


  右边是博客效果,左边则是对应的Markdown代码。由于版本问题,原先使用的第一种方式全部无效,只能使用语法要求的第二种方式( 请看这里),留意两个“##”之后的空格,再输入标题,至于标题后面的两个“##”,可有可无,建议不要带,毕竟少敲两个字符,而且符合标准语法一定不会错。

文章目录